<html><head><base href="placeholder"></head><body><div class="bottom"><icon src="AllIcons.Nodes.Package">&nbsp;<a href="psi_element://java.lang"><code><span style="color:#000000;">java.lang</span></code></a></div><div class='definition'><pre><span style="color:#000080;font-weight:bold;">public final</span> <span style="color:#000080;font-weight:bold;">class</span> <span style="color:#000000;">String</span>
<span style="color:#000080;font-weight:bold;">implements</span> <a href="psi_element://java.io.Serializable"><code><span style="color:#000000;">java.io.Serializable</span></code></a><span style="">,</span>&nbsp;<a href="psi_element://java.lang.Comparable"><code><span style="color:#000000;">Comparable</span></code></a><span style="">&lt;</span><a href="psi_element://java.lang.String"><code><span style="color:#000000;">String</span></code></a><span style="">&gt;</span><span style="">,</span>&nbsp;<a href="psi_element://java.lang.CharSequence"><code><span style="color:#000000;">CharSequence</span></code></a></pre></div><div class='content'>
  The <code>String</code> class represents character strings. All
  string literals in Java programs, such as <code>"abc"</code>, are
  implemented as instances of this class.
  <p>
  Strings are constant; their values cannot be changed after they
  are created. String buffers support mutable strings.
  Because String objects are immutable they can be shared. For example:
  <p><pre><code><span style="">String&#32;str&#32;=&#32;</span><span style="color:#008000;font-weight:bold;">"abc"</span><span style="">;</span></code></pre><p>
  is equivalent to:
  <p><pre><code><span style="color:#000080;font-weight:bold;">char&#32;</span><span style="">data[]&#32;=&#32;{</span><span style="color:#008000;font-weight:bold;">'a'</span><span style="">,&#32;</span><span style="color:#008000;font-weight:bold;">'b'</span><span style="">,&#32;</span><span style="color:#008000;font-weight:bold;">'c'</span><span style="">};<br></span><span style="">String&#32;str&#32;=&#32;</span><span style="color:#000080;font-weight:bold;">new&#32;</span><span style="">String(data);</span></code></pre><p>
  Here are some more examples of how strings can be used:
  <p><pre><code><span style="">System.out.println(</span><span style="color:#008000;font-weight:bold;">"abc"</span><span style="">);<br></span><span style="">String&#32;cde&#32;=&#32;</span><span style="color:#008000;font-weight:bold;">"cde"</span><span style="">;<br></span><span style="">System.out.println(</span><span style="color:#008000;font-weight:bold;">"abc"&#32;</span><span style="">+&#32;cde);<br></span><span style="">String&#32;c&#32;=&#32;</span><span style="color:#008000;font-weight:bold;">"abc"</span><span style="">.substring(</span><span style="color:#0000ff;">2</span><span style="">,</span><span style="color:#0000ff;">3</span><span style="">);<br></span><span style="">String&#32;d&#32;=&#32;cde.substring(</span><span style="color:#0000ff;">1</span><span style="">,&#32;</span><span style="color:#0000ff;">2</span><span style="">);</span></code></pre>
  <p>
  The class <code>String</code> includes methods for examining
  individual characters of the sequence, for comparing strings, for
  searching strings, for extracting substrings, and for creating a
  copy of a string with all characters translated to uppercase or to
  lowercase. Case mapping is based on the Unicode Standard version
  specified by the <a href="psi_element://java.lang.Character"><code><span style="color:#0000ff;">Character</span></code></a> class.
  <p>
  The Java language provides special support for the string
  concatenation operator (&nbsp;+&nbsp;), and for conversion of
  other objects to strings. String concatenation is implemented
  through the <code>StringBuilder</code>(or <code>StringBuffer</code>)
  class and its <code>append</code> method.
  String conversions are implemented through the method
  <code>toString</code>, defined by <code>Object</code> and
  inherited by all classes in Java. For additional information on
  string concatenation and conversion, see Gosling, Joy, and Steele,
  <i>The Java Language Specification</i>.

  <p> Unless otherwise noted, passing a <tt>null</tt> argument to a constructor
  or method in this class will cause a <a href="psi_element://java.lang.NullPointerException"><code><span style="color:#0000ff;">NullPointerException</span></code></a> to be
  thrown.

  <p>A <code>String</code> represents a string in the UTF-16 format
  in which <em>supplementary characters</em> are represented by <em>surrogate
  pairs</em> (see the section <a href="psi_element://java.lang.Character###unicode">Unicode
  Character Representations</a> in the <code>Character</code> class for
  more information).
  Index values refer to <code>char</code> code units, so a supplementary
  character uses two positions in a <code>String</code>.
  <p>The <code>String</code> class provides methods for dealing with
  Unicode code points (i.e., characters), in addition to those for
  dealing with Unicode code units (i.e., <code>char</code> values).

  </div><table class='sections'><p><tr><td valign='top' class='section'><p>Since:</td><td valign='top'><p>   JDK1.0</td><tr><td valign='top' class='section'><p>See Also:</td><td valign='top'><p><a href="psi_element://java.lang.Object#toString()"><code><span style="color:#0000ff;">Object</span><span style="">.</span><span style="color:#0000ff;">toString</span><span style="">()</span></code></a>,<br><a href="psi_element://java.lang.StringBuffer"><code><span style="color:#0000ff;">StringBuffer</span></code></a>,<br><a href="psi_element://java.lang.StringBuilder"><code><span style="color:#0000ff;">StringBuilder</span></code></a>,<br><span style="color:#ff0000">java.nio.charset.Charset</span></td><tr><td valign='top' class='section'><p>Author:</td><td valign='top'><p>Lee Boynton, Arthur van Hoff, Martin Buchholz, Ulf Zibis</td></table>